The 683-line protocol-spec.mdx contained all protocol documentation in a single file, making it difficult to navigate and maintain. Split into four focused documents organized in a dedicated protocol-spec/ subfolder with proper navigation hierarchy showing expandable second-level menu.

Changes

• Created protocol-spec/ subfolder to organize specification documents

• New documents (English + Chinese) in protocol-spec/ subfolder:

  • schema-definition.mdx - Object definitions, field types, constraints
  • query-dsl.mdx - Filters, sorting, pagination, field selection
  • aggregation.mdx - GroupBy, aggregate functions, having clause
  • mutation.mdx - Insert, update, delete, batch operations

• Moved protocol-spec.mdx to protocol-spec/index.mdx to enable expandable navigation:

  • Protocol architecture summary
  • Links to four main components in subfolder
  • Quick start example spanning all operations
  • Enables second-level menu in sidebar

• Updated navigation in meta.json for both language versions

• Updated all internal links to reflect new subfolder paths

• Created meta.json in protocol-spec subfolder for navigation

• Security fix: Updated tj-actions/changed-files from v44 to v46.0.1 in .github/workflows/ai-translate.yml (CVE: secret exposure via action logs)

Structure

Before: Single file with all documentation

02-objectql/
├── protocol-spec.mdx (683 lines)

After: Organized in subfolder with expandable navigation

02-objectql/
└── protocol-spec/
    ├── index.mdx (overview)
    ├── meta.json
    ├── schema-definition.mdx
    ├── query-dsl.mdx
    ├── aggregation.mdx
    └── mutation.mdx

Screenshots

Protocol Specification with expandable second-level menu in sidebar:

Schema Definition page with breadcrumb navigation:

Overview page with component links:

Query DSL:

Aggregation Operations:

Mutation Operations:

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.